From 39be5d7d6076caa6b6ba1563446b71791234a74e Mon Sep 17 00:00:00 2001 From: "robertlipe@gmail.com" Date: Mon, 23 Jan 2012 02:40:56 +0000 Subject: [PATCH] Minor doc tweaks for 1.4.3. Add dg-200. git-svn-id: http://gpsbabel.googlecode.com/svn/trunk@4149 f51c46e8-681c-474f-0cfe-069cfd0219fb --- gpsbabel/xmldoc/formats/an1.xml | 2 +- gpsbabel/xmldoc/formats/delbin.xml | 7 +++- gpsbabel/xmldoc/formats/dg-100.xml | 28 ++++++++----- gpsbabel/xmldoc/formats/dg-200.xml | 23 +++++++++++ gpsbabel/xmldoc/formats/dna.xml | 13 +++--- gpsbabel/xmldoc/formats/easygps.xml | 17 ++++---- gpsbabel/xmldoc/formats/enigma.xml | 9 +++- gpsbabel/xmldoc/formats/enigma_wp.xml | 8 +++- gpsbabel/xmldoc/formats/exif.xml | 2 +- gpsbabel/xmldoc/formats/garmin_poi.xml | 21 +++++----- gpsbabel/xmldoc/formats/gcdb.xml | 11 +++-- gpsbabel/xmldoc/formats/gdb.xml | 15 +++---- gpsbabel/xmldoc/formats/geo.xml | 2 +- gpsbabel/xmldoc/formats/geonet.xml | 14 +++---- gpsbabel/xmldoc/formats/glogbook.xml | 16 ++++---- gpsbabel/xmldoc/formats/gopal.xml | 7 ++-- gpsbabel/xmldoc/formats/gpl.xml | 13 +++--- gpsbabel/xmldoc/formats/gpx.xml | 11 ++--- gpsbabel/xmldoc/formats/gtrnctr.xml | 4 +- gpsbabel/xmldoc/formats/hiketech.xml | 13 +++--- gpsbabel/xmldoc/formats/html.xml | 29 +++++++------ gpsbabel/xmldoc/formats/kml.xml | 4 +- gpsbabel/xmldoc/formats/lowranceusr.xml | 2 +- gpsbabel/xmldoc/formats/maggeo.xml | 34 +++++++-------- gpsbabel/xmldoc/formats/mapsend.xml | 9 ++-- gpsbabel/xmldoc/formats/mapsource.xml | 33 ++++++++------- gpsbabel/xmldoc/formats/msroute.xml | 41 ++++++++++--------- gpsbabel/xmldoc/formats/navicache.xml | 15 ++++--- gpsbabel/xmldoc/formats/openoffice.xml | 20 ++++----- .../xmldoc/formats/options/dg-200-erase.xml | 1 + .../formats/options/dg-200-erase_only.xml | 6 +++ gpsbabel/xmldoc/formats/ozi.xml | 10 ++--- gpsbabel/xmldoc/formats/palmdoc.xml | 17 ++++---- gpsbabel/xmldoc/formats/pathaway.xml | 14 +++---- gpsbabel/xmldoc/formats/pcx.xml | 3 -- gpsbabel/xmldoc/formats/s_and_t.xml | 31 ++++++++------ gpsbabel/xmldoc/formats/sbn.xml | 2 +- gpsbabel/xmldoc/formats/sbp.xml | 2 +- gpsbabel/xmldoc/formats/shape.xml | 4 +- 39 files changed, 281 insertions(+), 232 deletions(-) create mode 100644 gpsbabel/xmldoc/formats/dg-200.xml create mode 100644 gpsbabel/xmldoc/formats/options/dg-200-erase.xml create mode 100644 gpsbabel/xmldoc/formats/options/dg-200-erase_only.xml diff --git a/gpsbabel/xmldoc/formats/an1.xml b/gpsbabel/xmldoc/formats/an1.xml index b90535736..70941595e 100644 --- a/gpsbabel/xmldoc/formats/an1.xml +++ b/gpsbabel/xmldoc/formats/an1.xml @@ -1,5 +1,5 @@ -This format supports the DeLorme ".an1" drawing file format. It can +This format supports the DeLorme ".an1" drawing file format used by their desktop software like Topo USA. It can currently be used to either read or write drawing files. If you use this format to create drawing files with routes or waypoints from another source, by default it will create "Red Flag" symbols for waypoints, and diff --git a/gpsbabel/xmldoc/formats/delbin.xml b/gpsbabel/xmldoc/formats/delbin.xml index 40df43e09..4c6806cc0 100644 --- a/gpsbabel/xmldoc/formats/delbin.xml +++ b/gpsbabel/xmldoc/formats/delbin.xml @@ -1,5 +1,10 @@ - The 'delbin' module supports DeLorme PN-20, PN-30, PN-40, and PN-40 SE receivers. + The 'delbin' module supports +DeLorme PN-20, +DeLorme PN-30, +DeLorme PN-40, +DeLorme PN-40 SE, and +DeLorme PN 60 receivers. Not all strains of Linux are supported. Fedora 7 is known not to work, for example. diff --git a/gpsbabel/xmldoc/formats/dg-100.xml b/gpsbabel/xmldoc/formats/dg-100.xml index b9abe6c90..a8240653f 100644 --- a/gpsbabel/xmldoc/formats/dg-100.xml +++ b/gpsbabel/xmldoc/formats/dg-100.xml @@ -1,7 +1,15 @@ -Serial download protocol for the GlobalSat DG-100, GlobalSat BT-335, and GlboalSat BT-338XGPS data loggers. -While the DG-100 has a button to record waypoints, they seem to be indistinguishable from trackpoints. Therefore, all points will be presented as trackpoints, disregarding whether they were recorded automatically or manually. -GlobalSat DG-100 + Serial download protocol for the GlobalSat DG-100, + GlobalSat BT-335, + and GlboalSat BT-338XGPS data loggers. + + + While the DG-100 has a button to record waypoints, they seem to be indistinguishable + from trackpoints. Therefore, all points will be presented as trackpoints, + regardless of whether they were recorded automatically or manually. + + + GlobalSat DG-100 Command showing DG-100 download and erase on Linux @@ -13,11 +21,11 @@ -The DG-100 provides a physical USB interface to the host computer, but -internally it uses a Prolific PL-2303 chip to do this. So you must have -drivers installed on your computer to recognize the PL-2303 and provide -that data as a serial port to software like GPSBabel. Such software -comes with the unit for Windows. Prolific provides software for Mac OS/X, -but unfortunately their driver has a defect which makes it unusable with -GPSBabel. + The DG-100 provides a physical USB interface to the host computer, but + internally it uses a Prolific PL-2303 chip to do this. So you must have + drivers installed on your computer to recognize the PL-2303 and provide + that data as a serial port to software like GPSBabel. Such software + comes with the unit for Windows. Prolific provides software for Mac OS/X, + but unfortunately their driver has a defect which makes it unstable with + GPSBabel. diff --git a/gpsbabel/xmldoc/formats/dg-200.xml b/gpsbabel/xmldoc/formats/dg-200.xml new file mode 100644 index 000000000..bde00c63a --- /dev/null +++ b/gpsbabel/xmldoc/formats/dg-200.xml @@ -0,0 +1,23 @@ +Serial download protocol for the GlobalSat DG-200GPS data loggers. + +GlobalSat DG-200 + + + Command showing DG-200 download and erase on Linux + gpsbabel -t -i dg-200,erase -o gpx /dev/ttyUSB0 outputfile.gpx + + + Command showing DG-200 erase_only option on Linux + gpsbabel -t -i dg-200,erase_only /dev/ttyUSB0 + + + + The DG-200 provides a physical USB interface to the host computer, but + internally it uses a Prolific PL-2303 chip to do this. So you must have + drivers installed on your computer to recognize the PL-2303 and provide + that data as a serial port to software like GPSBabel. Such software + comes with the unit for Windows. Prolific provides software for Mac OS/X, + but unfortunately their driver has a defect which makes it unstable with + GPSBabel. + + diff --git a/gpsbabel/xmldoc/formats/dna.xml b/gpsbabel/xmldoc/formats/dna.xml index 8e12bb670..567f91688 100644 --- a/gpsbabel/xmldoc/formats/dna.xml +++ b/gpsbabel/xmldoc/formats/dna.xml @@ -1,8 +1,7 @@ - - - - Navitrak DNA marker format - Another CSV format file. This -is the format that is compatible with the DNA Desktop import/export -command. Reading the binary Markers.jwp format directly off the data -card is not supported yet. Contributed by Tim Zickus. + + Navitrak DNA marker format - Another CSV format file. This + is the format that is compatible with the DNA Desktop import/export + command. Reading the binary Markers.jwp format directly off the data + card is not supported yet. Contributed by Tim Zickus. + diff --git a/gpsbabel/xmldoc/formats/easygps.xml b/gpsbabel/xmldoc/formats/easygps.xml index 3f940d3da..100150d47 100644 --- a/gpsbabel/xmldoc/formats/easygps.xml +++ b/gpsbabel/xmldoc/formats/easygps.xml @@ -1,12 +1,11 @@ - - - - This is the binary file format used by EasyGPS -format is seemingly being phased out in favor of GPX in newer versions -of EasyGPS, but this allows conversions to and from the old binary -.loc format. + + This is the binary file format used by EasyGPS + format is seemingly being phased out in favor of GPX in newer versions + of EasyGPS, but this allows conversions to and from the old binary + .loc format. - Information about and sketchy code to implement this file -format were provided by Eric Cloninger. + + Information about and sketchy code to implement this file + format were provided by Eric Cloninger. diff --git a/gpsbabel/xmldoc/formats/enigma.xml b/gpsbabel/xmldoc/formats/enigma.xml index da9a56b83..dcb1ef0ce 100755 --- a/gpsbabel/xmldoc/formats/enigma.xml +++ b/gpsbabel/xmldoc/formats/enigma.xml @@ -1,6 +1,11 @@ - This MGL Avionics format holds waypoints or routes. This routes can be loaded by the MGL Stratomaster Enigma EFIS series (Enigma, Odyssey, Voyager, Explorer). + This MGL Avionics format holds waypoints or routes. This routes can be loaded by the MGL Stratomaster Enigma EFIS series ( +Enigma, +Odyssey, +Voyager, +Explorer). - The format is designed for microcontrollers. The use is free for any none military application. You can find a detailed description in the MGL Documentation. + The format is designed for microcontrollers. The use is free for any non-military + application. You can find a detailed description in the MGL Documentation. diff --git a/gpsbabel/xmldoc/formats/enigma_wp.xml b/gpsbabel/xmldoc/formats/enigma_wp.xml index 4adcb9d84..e627bf9b1 100755 --- a/gpsbabel/xmldoc/formats/enigma_wp.xml +++ b/gpsbabel/xmldoc/formats/enigma_wp.xml @@ -1,6 +1,10 @@ - The MGL Avionics format holds waypoints or routes. These routes can be loaded by the MGL Stratomaster Enigma EFIS series (Enigma, Odyssey, Voyager, Explorer). + The MGL Avionics format holds waypoints or routes. These routes can be loaded by the MGL Stratomaster Enigma EFIS series ( +Enigma, +Odyssey, +Voyager, +Explorer). - The format is designed for microcontrollers. The use is free for any none military application. You can find a detailed description in the MGL Documentation. + The format is designed for microcontrollers. The use is free for any non-military application. You can find a detailed description in the MGL Documentation. diff --git a/gpsbabel/xmldoc/formats/exif.xml b/gpsbabel/xmldoc/formats/exif.xml index d8d1bc48b..e868b4bc6 100644 --- a/gpsbabel/xmldoc/formats/exif.xml +++ b/gpsbabel/xmldoc/formats/exif.xml @@ -3,7 +3,7 @@ EXIF, the Exchangeable Image Format, data. EXIF is a standardized method of encoding data in pictures such as JPEG, TIFF, and WAV and is frequently - used by mobile phones with cameras, cameras with built-in GPS. + used by mobile phones with cameras and cameras with built-in GPS. EXIF is frequently used for Geolocating photographs so their images can be diff --git a/gpsbabel/xmldoc/formats/garmin_poi.xml b/gpsbabel/xmldoc/formats/garmin_poi.xml index e2059bd00..d807f9b90 100644 --- a/gpsbabel/xmldoc/formats/garmin_poi.xml +++ b/gpsbabel/xmldoc/formats/garmin_poi.xml @@ -1,14 +1,13 @@ - - - - The Garmin POI loader -loads custom points of interest into certain models of -Garmin GPS receivers. (As of this writing, only the models introduced -in 2005 and later are supported. See Garmin's site for more info.) -The garmin_poi format produces csv files that can be - converted into POI files by Garmin's POI loader. -This format was mostly useful when POI Loader couldn't read GPX and we -couldn't write GPI. See GPSBabel's GPI doc. + The Garmin POI loader + loads custom points of interest into certain models of + Garmin GPS receivers. (As of this writing, only the models introduced + in 2005 and later are supported. See Garmin's site for more info.) + The garmin_poi format produces csv files that can be + converted into POI files by Garmin's POI loader. + + + This format was mostly useful when POI Loader couldn't read GPX and we + couldn't write GPI. See GPSBabel's GPI doc. diff --git a/gpsbabel/xmldoc/formats/gcdb.xml b/gpsbabel/xmldoc/formats/gcdb.xml index d9e1d4d53..52a7873a7 100644 --- a/gpsbabel/xmldoc/formats/gcdb.xml +++ b/gpsbabel/xmldoc/formats/gcdb.xml @@ -1,7 +1,6 @@ - - This is format for the - -GeocachingDB program by DougsBrat. It works with v2 -and v3 of this program. - + + This is format for the + GeocachingDB + program by DougsBrat. It works with v2 and v3 of this program. + diff --git a/gpsbabel/xmldoc/formats/gdb.xml b/gpsbabel/xmldoc/formats/gdb.xml index 80788965e..b1a8afec1 100644 --- a/gpsbabel/xmldoc/formats/gdb.xml +++ b/gpsbabel/xmldoc/formats/gdb.xml @@ -1,12 +1,13 @@ -Support for the "Garmin GPS Database" format used by -default in MapSource versions since release 6.0 of -that product. By default GPSBabel creates -gdb files of version 2. Version 2 is used in Mapsource 6.3 and 6.5. + Support for the "Garmin GPS Database" format used by + default in MapSource versions since release 6.0 of + that product. By default GPSBabel creates + gdb files of version 2. Version 2 is used in Mapsource 6.3 and 6.5. This format + is also used by Garmin BaseCamp for Mac and Windows. -Garmin GPS database is an undocumented file format. The -basic info for this module came from the existing MapSource -conversion code. + Garmin GPS database is an undocumented file format. The + basic info for this module came from the existing MapSource + conversion code. diff --git a/gpsbabel/xmldoc/formats/geo.xml b/gpsbabel/xmldoc/formats/geo.xml index f730600cd..54e589f33 100644 --- a/gpsbabel/xmldoc/formats/geo.xml +++ b/gpsbabel/xmldoc/formats/geo.xml @@ -7,7 +7,7 @@ or GPX formats for more general EasyGPS support. This is a simple XML-based format containing only very basic information about geocaches. If you can use the GPX -format instead, you should consider doing so as it is a much richer format. +format from Pocket Queries instead, you should consider doing so as it is a much richer format. We have a separate page describing how to send from Geocaching.com pages to GPS diff --git a/gpsbabel/xmldoc/formats/geonet.xml b/gpsbabel/xmldoc/formats/geonet.xml index 44e255ed8..d50bcf306 100644 --- a/gpsbabel/xmldoc/formats/geonet.xml +++ b/gpsbabel/xmldoc/formats/geonet.xml @@ -1,8 +1,6 @@ - - - - Input support for the GEOnet Names Server (GNS) country -file structure. Export to this format is not possible, as this format -has too many fields that we never get populated by any other -format. - + + Input support for the GEOnet Names Server (GNS) country + file structure. Export to this format is not possible, as this format + has too many fields that we never get populated by any other + format. + diff --git a/gpsbabel/xmldoc/formats/glogbook.xml b/gpsbabel/xmldoc/formats/glogbook.xml index bbaa7b02b..877bd1b72 100644 --- a/gpsbabel/xmldoc/formats/glogbook.xml +++ b/gpsbabel/xmldoc/formats/glogbook.xml @@ -1,11 +1,9 @@ + + This is the XML format used by the Garmin Logbook product + that ships with Forerunner and Foretrex. + As of early 2006, this program is apparently been discontinued in favor of + Garmin Training Center. - - - This is the XML format used by the Garmin Logbook product -that ships with Forerunner and Foretrex. -As of early 2006, this program is apparently been discontinued in favor of -Garmin Training Center. - -See: http://www.garmin.com - + See: http://www.garmin.com + diff --git a/gpsbabel/xmldoc/formats/gopal.xml b/gpsbabel/xmldoc/formats/gopal.xml index 2e692e4a5..a26665820 100644 --- a/gpsbabel/xmldoc/formats/gopal.xml +++ b/gpsbabel/xmldoc/formats/gopal.xml @@ -1,6 +1,7 @@ -The gopal format is a track format written by the - - GoPal Navigation program. + + The gopal format is a track format written by the + GoPal Navigation program. + The format of the file itself is quite simple: diff --git a/gpsbabel/xmldoc/formats/gpl.xml b/gpsbabel/xmldoc/formats/gpl.xml index cace2eaa4..1b4397c32 100644 --- a/gpsbabel/xmldoc/formats/gpl.xml +++ b/gpsbabel/xmldoc/formats/gpl.xml @@ -1,8 +1,7 @@ - - - - This is the 'gpl' format as used in Delorme mapping -products. It is a track format and contains little more than the -tracklog of a GPS that was attached while driving. frontiernet.net - + + This is the 'gpl' format as used in Delorme mapping + products. It is a track format and contains little more than the + tracklog of a GPS that was attached while driving. + frontiernet.net + diff --git a/gpsbabel/xmldoc/formats/gpx.xml b/gpsbabel/xmldoc/formats/gpx.xml index a9b239363..4a29daacc 100644 --- a/gpsbabel/xmldoc/formats/gpx.xml +++ b/gpsbabel/xmldoc/formats/gpx.xml @@ -1,8 +1,5 @@ - - - -This is the most capable and expressive of all the file -formats supplied. It is described at topografix.com and is +This is one of the most capable and expressive formats of all the file +formats supported by GPSBabel. It is described at topografix.com and is supported by EasyGPS, ExpertGPS, and many other programs described at topografix.com @@ -10,8 +7,8 @@ supported by EasyGPS, ExpertGPS, and many other programs described at GPSBabel's reader of this module attempts to preserve tags it doesn't really understand. It also tries to glean interesting data from - pocket queries from Geocaching.com - Garmin's "gpxx" GPX extensions. + pocket queries from Geocaching.com, + Garmin's "gpxx" GPX extensions, Humminbird's "h" GPX extensions. diff --git a/gpsbabel/xmldoc/formats/gtrnctr.xml b/gpsbabel/xmldoc/formats/gtrnctr.xml index cc967b588..fa2459b1f 100644 --- a/gpsbabel/xmldoc/formats/gtrnctr.xml +++ b/gpsbabel/xmldoc/formats/gtrnctr.xml @@ -1,7 +1,7 @@ GPSBabel supports reading and writing of tracks in the .tcx -format used by Garmin Training Center (GTC). GTC is the successor -to Garmin's Logbook program for their workout units. It is a +format used by Garmin Training Center (GTC). GTC is the successor +to Garmin's Logbook program for their workout units. It is a free upgrade. diff --git a/gpsbabel/xmldoc/formats/hiketech.xml b/gpsbabel/xmldoc/formats/hiketech.xml index 65d69bf7d..b9219caf7 100644 --- a/gpsbabel/xmldoc/formats/hiketech.xml +++ b/gpsbabel/xmldoc/formats/hiketech.xml @@ -1,8 +1,7 @@ - - - - This is the .gps format used by the Mac OS X applications -written by HikeTech. These include TopoDraw, Link2GPS, and GPSWrite. -More information about these products can be found at hiketech.com - + + This is the .gps format used by the Mac OS X applications + written by HikeTech. These include TopoDraw, Link2GPS, and GPSWrite. + More information about these products can be found at + hiketech.com + diff --git a/gpsbabel/xmldoc/formats/html.xml b/gpsbabel/xmldoc/formats/html.xml index 211da87ff..1c53699a3 100644 --- a/gpsbabel/xmldoc/formats/html.xml +++ b/gpsbabel/xmldoc/formats/html.xml @@ -1,16 +1,21 @@ - GPSBabel's HTML output generates a single HTML file of all of the -waypoints in the input file. It supports a number of Groundspeak GPX -extensions and filters out potentially harmful HTML from the -input file while maintaining almost all of the source HTML formatting. -This makes this format well suited for generating HTML to hand to programs -like Plucker for putting in a PDA and especially so for "paperless caching" -for Geocachers with pocket queries. + + GPSBabel's HTML output generates a single HTML file of all of the + waypoints in the input file. It supports a number of Groundspeak GPX + extensions and filters out potentially harmful HTML from the + input file while maintaining almost all of the source HTML formatting. + This makes this format well suited for generating HTML to hand to programs + like Plucker for putting in a PDA and especially so for "paperless caching" + for Geocachers with pocket queries. -This format is similar to the text format. + + This format is similar to the text format. - The following command line reads a GPX file with -Groundspeak extensions and writes an HTML file with encrypted hints -that is rendered using a custom stylesheet: + + The following command line reads a GPX file with + Groundspeak extensions and writes an HTML file with encrypted hints + that is rendered using a custom stylesheet: + + + gpsbabel -i gpx -f 12345.gpx -o html,stylesheet=green.css,encrypt -F 12345.html -gpsbabel -i gpx -f 12345.gpx -o html,stylesheet=green.css,encrypt -F 12345.html diff --git a/gpsbabel/xmldoc/formats/kml.xml b/gpsbabel/xmldoc/formats/kml.xml index 6fa86fe57..687521e9a 100644 --- a/gpsbabel/xmldoc/formats/kml.xml +++ b/gpsbabel/xmldoc/formats/kml.xml @@ -1,5 +1,5 @@ -KML, the Keyhole Markup Language, is used by Keyhole and +KML, the Keyhole Markup Language format, was used by Keyhole and is used by Google Earth. There are concepts in KML that GPSBabel can't support very well on @@ -7,7 +7,7 @@ read becuase they don't map well into other programs. For example, KML has ideas of camera views and names and descriptions can have arbitrarily complicated HTML in them. KML files may have tiered "Styles" which can identify sizing info and URLs of associated icons. Reading such -files with GPSBabel - even if your goal it to out to KML - can often +files with GPSBabel - even if your goal it to write it back out as KML - can often have suprising results. Simple files with waypoints and paths (which GPSBabel represents internally as tracks) work fine. diff --git a/gpsbabel/xmldoc/formats/lowranceusr.xml b/gpsbabel/xmldoc/formats/lowranceusr.xml index 99fe49495..55ed42c58 100644 --- a/gpsbabel/xmldoc/formats/lowranceusr.xml +++ b/gpsbabel/xmldoc/formats/lowranceusr.xml @@ -1,5 +1,5 @@ -The Lowrance iFinder GPS series has the unique capability +The Lowrance iFinder GPS series has the unique capability within the Lowrance models to output its data to an MMC card. The data is saved to the card as a .USR file and can be read by your computer using a card reader. Waypoints, icons, routes, tracks are supported. Event marker icons contain a symbol, name, latitude and longitude diff --git a/gpsbabel/xmldoc/formats/maggeo.xml b/gpsbabel/xmldoc/formats/maggeo.xml index 5f88c672a..1ec14617e 100644 --- a/gpsbabel/xmldoc/formats/maggeo.xml +++ b/gpsbabel/xmldoc/formats/maggeo.xml @@ -1,17 +1,19 @@ - - - - This format supports the on-card format used by the Magellan Explorist 400, -Explorist 500, Explorist 600, Explorist 210, and Explorist XL -to describe geocaches. Notice what while the format can -hold an infinite number of geocaches, the unit will read and silently -discard all but 200 geocache POIs at a time. - You should name any file created with this format with a -".gs" extension so the firmware can read it. + + This format supports the on-card format used by the + Magellan Explorist 400, + Explorist 500, Explorist 600, Explorist 210, and Explorist XL + to describe geocaches. Notice what while the format can + hold an infinite number of geocaches, the unit will read and silently + discard all but 200 geocache POIs at a time. + + You should name any file created with this format with a ".gs" extension + so the firmware can read it. + + + This format does support reading .gs files, but it's kind of a + pointless operation as the units can't create or edit these files. + Round-tripped data is lossy for all but the most trivial cases as + many fields are shortened or discarded on write. "Date last found" is + discarded on read as there are no logs stored on the device in which to + store the date last found. -This format does support reading .gs files, but it's kind of a -pointless operation as the units can't create or edit these files. -Round-tripped data is lossy for all but the most trivial cases as -many fields are shortened or discarded on write. "Date last found" is -discarded on read as there are no logs stored on the device in which to -store the date last found. diff --git a/gpsbabel/xmldoc/formats/mapsend.xml b/gpsbabel/xmldoc/formats/mapsend.xml index a33cdc3bc..853a3b7b9 100644 --- a/gpsbabel/xmldoc/formats/mapsend.xml +++ b/gpsbabel/xmldoc/formats/mapsend.xml @@ -1,8 +1,9 @@ -This format supports the Magellan MapSend native -file format. + This format supports the + Magellan + MapSend native file format. -Kudos to Magellan for having the foresight to document their file formats, -making software like this possible. + Kudos to Magellan for having the foresight to document their file formats, + making software like this possible. diff --git a/gpsbabel/xmldoc/formats/mapsource.xml b/gpsbabel/xmldoc/formats/mapsource.xml index 7460e008b..1d3c97d92 100644 --- a/gpsbabel/xmldoc/formats/mapsource.xml +++ b/gpsbabel/xmldoc/formats/mapsource.xml @@ -1,28 +1,27 @@ -This format supports the Garmin Mapsource -product family. + This format supports the Garmin Mapsource product family. -This format is based on significant reverse-engineering and guesswork. -GPSBabel's output appears to be compatible with the various versions of -MapSource. Icon mapping is attempted between different MapSource versions. -Altitude is supported, but proximity and depth are not. + This format is based on significant reverse-engineering and guesswork. + GPSBabel's output appears to be compatible with the various versions of + MapSource. Icon mapping is attempted between different MapSource versions. + Altitude is supported, but proximity and depth are not. -Naming files *.mps will allow file->open in Mapsource to find the files -more easily. + Naming files *.mps will allow file->open in Mapsource to find the files + more easily. -Versions 3, 4, and 5 of the Mapsource data format are handled automatically -on input. By default the output is version 5. (Until 3/2004, it was -version 3, but since Mapsource updates are free, the convenience of -having modern icon sets outweighs the backward compatibility concern. -Users of other versions can either upgrade or specify the switches to -get output in a compatible format.) Waypoints, routes, and tracklogs are -all handled, but map sets are ignored. + Versions 3, 4, and 5 of the Mapsource data format are handled automatically + on input. By default the output is version 5. (Until 3/2004, it was + version 3, but since Mapsource updates are free, the convenience of + having modern icon sets outweighs the backward compatibility concern. + Users of other versions can either upgrade or specify the switches to + get output in a compatible format.) Waypoints, routes, and tracklogs are + all handled, but map sets are ignored. -Information on the Garmin Mapsource format was provided by Ian Cowley and -Mark Bradley. The code was implemented by Robert Lipe and Mark Bradley. + Information on the Garmin Mapsource format was provided by Ian Cowley and + Mark Bradley. The code was implemented by Robert Lipe and Mark Bradley. diff --git a/gpsbabel/xmldoc/formats/msroute.xml b/gpsbabel/xmldoc/formats/msroute.xml index d1d4d36b2..1ce5744c7 100644 --- a/gpsbabel/xmldoc/formats/msroute.xml +++ b/gpsbabel/xmldoc/formats/msroute.xml @@ -1,22 +1,25 @@ + + Input support for Microsoft AutoRoute 2002-2006 .axe files + and Microsoft Streets and Trips .est files. This is for reading routes + created this program and is different than the + s_and_t format used for writing pushpins. + These files contains only routes. We can extract the coordinates and + the names of the points within route. An export to this format will + not be supported. + - - - Input support for Microsoft AutoRoute 2002-2006 .axe files -and Microsoft Streets and Trips .est files. This is for reading routes -created this program and is different than the -s_and_t format used for writing pushpins. -These files contains only routes. We can extract the coordinates and -the names of the points within route. An export to this format will -not be supported. - Only the start, stops, and end points are stored in the -.est/.axe/.ptm files. Turn-by-turn route data is not stored in the -.est/.axe/.ptm files, and is recalculated by the Microsoft title each -time on opening the file. This means that the output of GPSBabel will -not contain turns needed for driving directions. - One possible approach to achieve similar results is to -use the Streets and Trips drawing tools to trace a line over the -interesting parts of the route to capture intersections or key turns. -GPSBabel will capture stops in the route and insert those as turns, so -adding stops at intersections can also improve the results when converting. + + Only the start, stops, and end points are stored in the + .est/.axe/.ptm files. Turn-by-turn route data is not stored in the + .est/.axe/.ptm files, and is recalculated by the Microsoft title each + time on opening the file. This means that the output of GPSBabel will + not contain turns needed for driving directions. + + + One possible approach to achieve similar results is to + use the Streets and Trips drawing tools to trace a line over the + interesting parts of the route to capture intersections or key turns. + GPSBabel will capture stops in the route and insert those as turns, so + adding stops at intersections can also improve the results when converting. diff --git a/gpsbabel/xmldoc/formats/navicache.xml b/gpsbabel/xmldoc/formats/navicache.xml index 6400ce3c4..120c54b10 100644 --- a/gpsbabel/xmldoc/formats/navicache.xml +++ b/gpsbabel/xmldoc/formats/navicache.xml @@ -1,9 +1,8 @@ - - - - This is the XML format that's used by Navicache.com for -their geocaching data. There are a number of fields in it that are -marked "required" but are Navicache-specific, so GPSBabel can not -write these files, but we can still read them. navicache.com - + + This is the XML format that's used by Navicache.com for + their geocaching data. There are a number of fields in it that are + marked "required" but are Navicache-specific, so GPSBabel can not + write these files, but we can still read them. + navicache.com + diff --git a/gpsbabel/xmldoc/formats/openoffice.xml b/gpsbabel/xmldoc/formats/openoffice.xml index 56d50f1c0..036336d73 100644 --- a/gpsbabel/xmldoc/formats/openoffice.xml +++ b/gpsbabel/xmldoc/formats/openoffice.xml @@ -1,11 +1,9 @@ - - - - Tab seperated export-all (except geocaching data) file -format. Intended to serve as source for number-processing -applications like OpenOffice, Ploticus and others. Tab was chosen as -delimiter because it is a) supported by both OpenOffice and Ploticus -and b) is not ',', so you can use sed -i -"s/./,/g" <x>.csv' to adapt it to locales where ',' is -used as decimal seperator. Contributed by Tobias Minich. - + + Tab seperated export-all (except geocaching data) file + format. Intended to serve as source for number-processing + applications like OpenOffice, Ploticus and others. Tab was chosen as + delimiter because it is a) supported by both OpenOffice and Ploticus + and b) is not ',', so you can use sed -i + "s/./,/g" <x>.csv' to adapt it to locales where ',' is + used as decimal seperator. Contributed by Tobias Minich. + diff --git a/gpsbabel/xmldoc/formats/options/dg-200-erase.xml b/gpsbabel/xmldoc/formats/options/dg-200-erase.xml new file mode 100644 index 000000000..95424f0dd --- /dev/null +++ b/gpsbabel/xmldoc/formats/options/dg-200-erase.xml @@ -0,0 +1 @@ +This option erases the track log from the device after download. diff --git a/gpsbabel/xmldoc/formats/options/dg-200-erase_only.xml b/gpsbabel/xmldoc/formats/options/dg-200-erase_only.xml new file mode 100644 index 000000000..6479f86f5 --- /dev/null +++ b/gpsbabel/xmldoc/formats/options/dg-200-erase_only.xml @@ -0,0 +1,6 @@ + + Much like the this optio erases the data in the GPS. + It does not transfer data before doing so, making it much faster. This may + be handy in a work flow where you want to transfer the data from the GPS, + check it on a map, and then remove it from the unit. + diff --git a/gpsbabel/xmldoc/formats/ozi.xml b/gpsbabel/xmldoc/formats/ozi.xml index 1e3819a0e..00d9bafd4 100644 --- a/gpsbabel/xmldoc/formats/ozi.xml +++ b/gpsbabel/xmldoc/formats/ozi.xml @@ -1,7 +1,5 @@ - - - - OziExplorer Waypoint Format - Another CSV format file. -Tested against OziExplorer v 3.90.3a / Shareware. Contributed by Alex -Mottram + + OziExplorer Waypoint Format - Another CSV format file. + Tested against OziExplorer v 3.90.3a / Shareware. Contributed by Alex Mottram + diff --git a/gpsbabel/xmldoc/formats/palmdoc.xml b/gpsbabel/xmldoc/formats/palmdoc.xml index 2ed7ff68b..febf0a466 100644 --- a/gpsbabel/xmldoc/formats/palmdoc.xml +++ b/gpsbabel/xmldoc/formats/palmdoc.xml @@ -1,13 +1,14 @@ -PalmDoc output is similar to Text -output, except that it generates a Palm Database (PDB) file suitable for -use with programs like CSpotRun, TealDoc, AportisDoc, Palm Reader, and -others. The resulting file also contains bookmarks to make it easy to jump -to a particular waypoint. + PalmDoc output is similar to Text + output, except that it generates a Palm Database (PDB) file suitable for + use with programs like CSpotRun, TealDoc, AportisDoc, Palm Reader, and + others. The resulting file also contains bookmarks to make it easy to jump + to a particular waypoint. -The following command line reads a GPX file with Groundspeak extensions -and writes a Palm document with encrypted hints and logs: + The following command line reads a GPX file with Groundspeak extensions + and writes a Palm document with encrypted hints and logs: + +gpsbabel -i gpx -f 12345.gpx -o "palmdoc,dbname=Unfound Geocaches,encrypt,logs" -F 12345.pdb -gpsbabel -i gpx -f 12345.gpx -o "palmdoc,dbname=Unfound Geocaches,encrypt,logs" -F 12345.pdb diff --git a/gpsbabel/xmldoc/formats/pathaway.xml b/gpsbabel/xmldoc/formats/pathaway.xml index 435adff4d..8310068c0 100644 --- a/gpsbabel/xmldoc/formats/pathaway.xml +++ b/gpsbabel/xmldoc/formats/pathaway.xml @@ -1,10 +1,8 @@ - - - - PathAway is a Palm software designed for handling "most" -GPS devices (including BlueTooth). In this time (I mean 2005) a free -tool to convert this database is located on the homepage of PathAway -(www.pathaway.com). But I've read there ... for windows and the output -formats are also very limited. + + PathAway is a Palm software designed for handling "most" + GPS devices (including BlueTooth). In this time (I mean 2005) a free + tool to convert this database is located on the homepage of PathAway + (www.pathaway.com). But I've read there ... for windows and the output + formats are also very limited. diff --git a/gpsbabel/xmldoc/formats/pcx.xml b/gpsbabel/xmldoc/formats/pcx.xml index 60abecec5..4c7330473 100644 --- a/gpsbabel/xmldoc/formats/pcx.xml +++ b/gpsbabel/xmldoc/formats/pcx.xml @@ -1,6 +1,3 @@ - - - Garmin documents only PCX5, an older format limited to the lame NMEA six-character waypoint names that's treated as a second-class citizien in current versions of MapSource. In Mapsource, diff --git a/gpsbabel/xmldoc/formats/s_and_t.xml b/gpsbabel/xmldoc/formats/s_and_t.xml index 2df639326..fda190d97 100644 --- a/gpsbabel/xmldoc/formats/s_and_t.xml +++ b/gpsbabel/xmldoc/formats/s_and_t.xml @@ -1,16 +1,23 @@ + This is a format for creating data to be read by + Microsoft Streets and + Trips. It's been exercised on versions from 2003 through 2008. Detailed + instructions on how to use it, including preserving hyperlinks, are at + gpsbabel.org + + + We have an additional page describing how to solve the + traveling salesman problem with + Streets & Trips to efficiently optimize a trip with many stops, such as + is often made by geocachers. + + + + This format has nothing to do with the .est/axe format + used by this program to store routes. + - - - This is a format for creating data to be read by - Microsoft Streets and -Trips. It's been exercised on versions from 2003 through 2008. Detailed -instructions on how to use it, including preserving hyperlinks, are at -gpsbabel.org - - We have an additional page describing how to solve the traveling salesman problem with Streets & Trips to efficiently optimize a trip with many stops, such as is often made by geocachers. + Since modern versions of Streets and Trips support reading GPX, this format is probably + not so useful. - - This format has nothing to do with the .est/axe format used by this program to store routes. - diff --git a/gpsbabel/xmldoc/formats/sbn.xml b/gpsbabel/xmldoc/formats/sbn.xml index 18d22215c..7adb91fd4 100644 --- a/gpsbabel/xmldoc/formats/sbn.xml +++ b/gpsbabel/xmldoc/formats/sbn.xml @@ -1,6 +1,6 @@ This format is for SBN datalog files saved to the SD card by - the Locosys GT-11/BGT-11/GT-31/BGT-31. + the Locosys GT-11/BGT-11/GT-31/BGT-31 GPS receivers. On the device, logging in this format is enabled by choosing diff --git a/gpsbabel/xmldoc/formats/sbp.xml b/gpsbabel/xmldoc/formats/sbp.xml index 98e61755c..7d41cb7f6 100644 --- a/gpsbabel/xmldoc/formats/sbp.xml +++ b/gpsbabel/xmldoc/formats/sbp.xml @@ -1,4 +1,4 @@ This format is for SBP datalog files saved to the SD card by - the Locosys GT-11/BGT-11/GT-31/BGT-31. + the Locosys GT-11/BGT-11/GT-31/BGT-31 GPS receivers. diff --git a/gpsbabel/xmldoc/formats/shape.xml b/gpsbabel/xmldoc/formats/shape.xml index fc97f6946..2c14744d7 100644 --- a/gpsbabel/xmldoc/formats/shape.xml +++ b/gpsbabel/xmldoc/formats/shape.xml @@ -3,12 +3,12 @@ reality is that shapefiles can contain a lot of map-oriented data that does not convert well to our model of waypoints, tracks, and routes. Points are mapped to waypoints. Arcs are mapped to tracks. -If a field is named 'NAME', that will be used for hte shortname. Likewise +If a field is named 'NAME', that will be used for the shortname. Likewise for a field named 'URL'. Given the forced fit nature of conversions between shapefiles and other -formats, the results of these conversions are frequently disappointing. +common consumer formats, the results of these conversions are frequently disappointing. A custom converter (perhaps via a modification to our source) will frequently deliver better results. -- 2.30.2